home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat2 / standard / newarraysess.z / newarraysess
Encoding:
Text File  |  2002-10-03  |  5.0 KB  |  133 lines
  1.  
  2.  
  3.  
  4. nnnneeeewwwwaaaarrrrrrrraaaayyyysssseeeessssssss((((2222))))                                                nnnneeeewwwwaaaarrrrrrrraaaayyyysssseeeessssssss((((2222))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      newarraysess - start a new array session
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ####iiiinnnncccclllluuuuddddeeee <<<<uuuunnnniiiissssttttdddd....hhhh>>>>
  13.  
  14.      iiiinnnntttt nnnneeeewwwwaaaarrrrrrrraaaayyyysssseeeessssssss((((vvvvooooiiiidddd))));;;;
  15.  
  16. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  17.      The _n_e_w_a_r_r_a_y_s_e_s_s function creates a new array session and moves the
  18.      current process from its original array session to the new one.  The
  19.      parents, children and siblings of the current process are not affected by
  20.      this and remain in their original array sessions.
  21.  
  22.      A handle for the new array session will be generated by the system.
  23.      Normally the new handle is guaranteed to be unique on the current system
  24.      only, though some systems may be able to assign global array session
  25.      handles that are unique across an entire array of systems by setting the
  26.      aaaassssmmmmaaaacccchhhhiiiidddd system variable.  Otherwise, the range of values that the system
  27.      may assign for array session handles is defined by the system variables
  28.      mmmmiiiinnnn____llllooooccccaaaallll____ppppaaaaggggggggiiiidddd and mmmmaaaaxxxx____llllooooccccaaaallll____ppppaaaaggggggggiiiidddd.  System variables can be examined
  29.      and/or modified with _s_y_s_t_u_n_e(1).  If necessary, the _s_e_t_a_s_h(2) function
  30.      can be used to override the default handle after the array session has
  31.      been created.
  32.  
  33.      The project ID and service provider information for the new array session
  34.      are taken from the original array session of the current process.  They
  35.      can be changed after the new array session has been created using the
  36.      _s_e_t_p_r_i_d(2) and _s_e_t_s_p_i_n_f_o(2) functions.
  37.  
  38.      For the purposes of array session accounting, it is undefined whether the
  39.      resources used by the current process are charged to the original array
  40.      session, the new array session, or split between both in some fashion.
  41.      It _i_s guaranteed that the process resources will be charged to at least
  42.      one of the two array sessions, and that if the resources are split
  43.      between the two array sessions, they will be split cleanly (in other
  44.      words, no "double-billing" will take place).
  45.  
  46.      Ordinarily, a new array session should be started whenever the conceptual
  47.      equivalent of a login is performed.  This would include programs that do
  48.      conventional logins (for example, _l_o_g_i_n(1) or _t_e_l_n_e_t(1)) as well as
  49.      programs that are essentially "logging in" to do work on behalf of
  50.      another user, such as _c_r_o_n(1) or batch queueing systems.
  51.  
  52.      Using the _a_r_s_o_p(2) function, it is possible to restrict the processes in
  53.      an array session from starting a new array session.  If this has been
  54.      done, then _n_e_w_a_r_r_a_y_s_e_s_s will fail with an EEEEPPPPEEEERRRRMMMM error.
  55.  
  56. EEEERRRRRRRROOOORRRRSSSS
  57.      _n_e_w_a_r_r_a_y_s_e_s_s may fail if the following condition is true:
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. nnnneeeewwwwaaaarrrrrrrraaaayyyysssseeeessssssss((((2222))))                                                nnnneeeewwwwaaaarrrrrrrraaaayyyysssseeeessssssss((((2222))))
  71.  
  72.  
  73.  
  74.      EEEENNNNOOOOMMMMEEEEMMMM    The system is unable to allocate memory or other resources for
  75.                the new array session.
  76.  
  77.      EEEEPPPPEEEERRRRMMMM     The current array session has been restricted from starting new
  78.                array sessions.
  79.  
  80.      EEEEIIIINNNNVVVVAAAALLLL    The current process is a batch process (see _m_i_s_e_r(_1) ). It is
  81.                not possible to create a new array session for a batch process.
  82.  
  83. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  84.      systune(1), miser(1), arsop(2), setash(2), setprid(2), setspinfo(2),
  85.      array_sessions(5), extacct(5).
  86.  
  87. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  88.      Upon successful completion, _n_e_w_a_r_r_a_y_s_e_s_s returns a value of 0.
  89.      Otherwise, a value of -1 is returned and eeeerrrrrrrrnnnnoooo is set to indicate the
  90.      error.
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.